Belgian Amiga Club - ADF Collection

home *** CD-ROM | disk | FTP | other *** search

/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / Disk Magic v1.0.adf / DISKMAGIC.DOC < prev next >

Wrap

Text File | 1988-12-27 | 48KB | 1,924 lines

TABLE OF CONTENTS 1.0 INTRODUCTION 2.0 GETTING STARTED 3.0 GETTING AROUND 3.1 Two File Select windows. 3.2 Parameters/Swap/Source/Destination 3.3 Front Gadget 3.4 Back Gadget 3.5 Drag Bar 3.6 Left Mouse Button 3.7 Right Mouse Button 3.8 Sound Toggle 3.9 Color mode Toggle 3.10 Menu mode Toggle 3.11 Improvements 4.0 DIRECTORY GADGETS AND MENUS 4.1 Start Up Directories 4.2 User defined directories 5.0 BASE FUNCTIONS 5.1 Highlighting Functions 5.2 Directory Functions 5.3 Type/Display Functions 5.4 File Functions 6.0 USER DEFINED GADGETS AND MENUS 6.1 Directory Gadgets And Menus 6.2 Program Menus 7.0 DISK MAGIC DEFINITION FILE 7.1 Color mode definition 7.2 Archive Pause Timer 7.3 Picture Pause Timer 7.4 Sound On/Off 7.5 Start up Source Directory 7.6 Start up Destination Directory 7.7 On Screen Directory Names 7.8 On Screen User Defined Directories 7.9 Program Menu Catagories 7.10 User Defined Directory Menu Names 7.11 User Defined Menu Directories 7.12 User Defined Menu Program Names 7.13 User Defined Menu Programs 7.14 User Defined Comments 7.15 User Menu Command Format Definitions 8.0 ALPHABETICAL LIST OF COMMANDS APPENDIX A. Shareware Copyright Notices 1.0 INTRODUCTION WELCOME TO THE WORLD OF DISK MAGIC ! DISK MAGIC is a user friendly CLI replacement program and graphics interface program with easily defined directories and functions. It provides a base set of built in functions such as file and directory copy/delete with functions such as PRINT being run in background mode. This program also has a built in directory catalog list function, and global rename function. There are 14 user definable directory gadgets and 18 user definable menu directories. Also there are 108 user definable program menus with a possibility of executing multiple commands by each menu item. DISK MAGIC is also a menu program driver. From CLI or your startup sequence you can run DISK MAGIC as follows: runb DISKMAGIC i This will run the program in background mode and come up with a menu bar that displays DATE, TIME, CHIP, FAST and TOTAL memory parameters. You can define a set of 6 menus that each contain 18 items each of which will execute the programs you define. The following sections will describe both modes. 2.0 GETTING STARTED First make (1) one backup copy of your DISK MAGIC disk. This disk has no copy protection to allow the user to place this software on any hard disk or any Amiga the purchaser owns. The DISK MAGIC files on the supplied disk are as follows: DISKMAGIC DISKMAGIC.info DISKMAGIC.data DISKMAGIC.pic4 DISKMAGIC.pic8 Please take the time to read the documentation to learn how to define the environment for DISK MAGIC. All DISK MAGIC files must be first copied to your workbench (TM) disk or a hard disk. The next version of DISKMAGIC will come with workbench and the AMIGA DOS (TM) operating system on version 2.0. The files in the 'C' directory must be copied to your sys:c directory and are listed as follows: runb - run a program in background mode. * ARC - Archive and de-archive file compression program. * ARC.doc * ZOO - Archive and de-archive file compression program. * ZOO.man * PAK - Archive and de-archive file compression program. * PAK.doc * PKAX - Archive de-compression file program by PAKWARE. Also included on the DISK MAGIC disk is a public domain hard drive backup utility called MRbackup. Each of the files (*) above are shareware programs that are included in this package to make it easy for you the user to obtain the programs that DISK MAGIC supports. Included on the DISK MAGIC DISK are a number of public domain programs and shareware programs. These are included as a service to supply the user with the complete tools to archive and de-archive files. THe programs are either freely distributable or permission was obtained from the author to supply you with these tools. FIRST SOME DEFINITIONS: A. Public Domain - These programs are freely distributable and can be used at no cost to you. B. Shareware - These programs are included on the disk to the user and if the user finds these programs useful then the user is asked to pay a registration fee. This fee is to support updates and to support the people that write the software. Different policies are in effect for each program and these policies can be found in APPENDIX A or by typing the name of the program and a carriage return. These programs are not free and by your own good conscience we here at DMH hope you will support the software developers of these excellent programs. 3.0 GETTING AROUND The following section describes how to select files and directories, how to get to other screens and how to get to other directories. All 4 DISK MAGIC files must be in the same directory. Also the execute and run commands must be in the C directory for this program to work. The following sections refer to figure 1 seen below and referenced by the numbers in the closed parentheses (). figure 1. 3.1 Two File Select windows. The DISK MAGIC screen has two files select windows at the top (1). One is the source screen and one is the destination screen. The MAGIC WAND in the center points at the Source select window. In these two windows both files and directories are displayed. The FILE names in white are actual files and the names in RED are the DIRECTORIES. The next section describes how to switch between the source and destination directories. 3.2 Parameters/Swap/Source/Destination DISK MAGIC has an entry line at the bottom of the screen. This is the parameter entry field (6). This field can be clicked on and the user can enter function parameters to be passed to a given function. Examples are as follows: P: The string to be passed: GRENAM - Input to the function as described in section 5.4 and section 8.0. RUN - parameters to be passed to program being run. EXECUTE - parameters to pass to the file being executed. The two text entry lines in the center of the screen below each file select window indicate the current source and destination directories that are displayed (3). The one that is highlighted in red is the source directory and the other is the destination directory. Through the rest of this document when referring to the source directory or the destination directory The one that is highlighted in red is the source directory and the other is the destination directory. To change the source directory to the destination directory just click with the left mouse button on the MAGIC WAND in the center of the screen and the directories will change. The WAND points to the source directory. Also, you can click in each one of these directories and type in a new directory and hit the carriage return key and the new directory will be loaded automatically. 3.3 Front Gadget The front gadget moves DISK MAGIC's screen to be the front screen in the system (7). This gadget is set up in a slightly different method from the normal front and back gadgets. when DISK MAGIC is not busy doing processing you can click any where on the front gadget and this will move the screen to the front. This part of the screen is really part of the window and is really not part of the screen front and back. If DISK MAGIC is busy (like arcing or dearcing files) you can still move the screen to the front or back by clicking at the very top portion of the front or back gadget and this will move the screen so you can get to your terminal program or any other function you have running. 3.4 Back Gadget This is the same as the front gadget accept it will move the screen to the back (7). 3.5 Drag Bar The Drag bar is only 2 pixels wide and is at the top of the screen (7). This allows you to slide the screen up and down. 3.6 Left Mouse Button The left mouse button is used to select files and directories in the file selection area, to activate the gadgets for DISK MAGIC, and also to stop processing. This is done by clicking anywhere on the screen that is not a GADGET. If this is done DISK MAGIC will finish the file that is being worked on and then terminate processing. 3.7 Right Mouse Button The right mouse button is used to get a given directory in the (1) file selection windows. For an example; The source directory is df0: In the file select area (1) you see a red file name 'C" indicating that this is a directory. This is the command directory. Place the pointer over the red file name and click the RIGHT mouse button on the directory name. The Source directory now becomes df0:C and the source file select area now displays all the files in that directory. 3.8 Sound Toggle The button in figure 1 labeled 'S' (2) is to toggle the sound on or off. 3.9 Color mode toggle Color mode toggle allows the user to switch between 4 color mode and 8 color mode. Figure 1 does not show this button. It is located to the left of the ZOO button and is labeled 'C'. Also, the picture files DISKMAGIC.pic4 and DISKMAGIC.pic8 can be modified by any paint program to the users desired color scheme. The default color can be defined in the user definition file and is described in section 7. 3.10 Menu mode Toggle This button (8) labeled 'I' toggles between menu mode and graphics mode. The benefit of menu mode is that it eliminates the over head of the screen and graphics display when only the menu command line is needed. NOTE: in menu mode the DIRECTORY MENU ITEMS ARE NOT VALID and only the MENU ITEM 'GET DISK MAGIC' is valid. By selecting this menu item you are returned to the graphics mode. Also, in menu mode all programs are executed from the menu with just the user defined command line and no files or directories are added. In this mode DISK MAGIC allows the user to access any command in any directory at the click of a button using the pull down menus. 3.11 IMPROVEMENTS Two improvements have been made. 1. When ever you operate the functions DEARC, DEZOO, ZOOLST, ARCLST, or PAKLST you have the option of changing the mode of the listing to one of the following: a. In the parameter entry window (6) you may enter a number from (1-99) before you operate any of the above functions. If you enter a 1 then the result listing of the above functions will wait for a carriage return from the user. b. If you enter a number from (2-99) DISK MAGIC will display the results for the entered number of seconds and then go on to the next file. 2. When ever you show a picture file you have the option of changing the mode of the listing to one of the following: a. In the parameter entry window you may enter a number from (1-99) before you operate the show function. If you enter a 1 then each of the selected picture files will be shown and DISK MAGIC will wait until the user clicks on the hidden close box at the top left hand corner of the screen. b. If you enter a number from (2-99) DISK MAGIC will display the selected pictures for the entered number of seconds and then go on to the next file. If no entry is made in the P: window then the operation will occur in the same mode as it was defined by the user defined data file or the last mode change the user made. 4.0 DIRECTORY GADGETS AND MENUS 4.1 Start Up Directories The Start up directories (those used on start up for the source and destination directories) can be defined by the user and are described in section 7.0. 4.2 User defined directories There are 14 user gadget directories (6) that can be defined by the user and also 18 user defined menu directories which are described in section 7.0. 5.0 BASE FUNCTIONS 5.1 Highlighting Functions ALL - Select ALL files in the current highlighted source directory, including the ones "scrolled off" the window. ALLDIRS - Highlights all directories. ALLWIND - Highlights all files in the highlighted source window (9 at a time). This is handy to archive a directory that is two large for a 3 1/2" disk. CLEAR - De-select all selected files in the highlighted source directory. CLRDIRS - Clears all selected directories in the highlighted source directory. CLRWIND - Clears all files in the highlighted source window. 5.2 Directory Functions CATLIST - This will list all files and directories and sub files and sub directories to the printer. This function starts from the Highlighted source directory found in the highlighted directory window. COPY - Copy selected files and directories to the directory specified in the unhighlighted destination string gadget. It must be an existing directory path and CAN go across devices. You should be able to enter paths relative to the current directory. NOTE! you can select both directories and files to be copied now. and all are done at the same time. DELETE - Delete selected files and directories in the Highlighted source directory. GETDIR - Gets the current directory in the highlighted source window. You can also click on the directory windows and then type in a new directory. Upon hitting carriage return the new directory is read in. MAKDIR - This will create the directory that you have typed in the highlighted source window gadget. You may use relative paths. ex: click on the highlighted string gadget and enter the following: ram: ---> ram:newdirectoryname or ram:DIR1 ---> ram:DIR1/newdirectoryname then click the gadget. The new directory will be made and the current directory will be returned to: ram: or ram:DIR1 respectively. The directory will be created in the highlighted source window. PARENT - Go to the parent directory in the highlighted source window. WAND - Used to flip the Source highlight from one widow directory to the other. 5.3 Type/Display Functions HTYPE - Types a file to the screen in HEX and ASCII 16 numbers at a time. PRINT - THIS FUNCTION IS NOW RUN OF AS A BACKGROUND JOB!!! Same as TYPE, but the output goes to PRT: TYPE - Use this to view standard ASCII (readme, docs, etc) on stdout; usually your CRT. Select the files you want to view, then select the TYPE gadget. A new window, with the window name being the file that you are currently viewing, will open. Use the space bar to advance by one screen, a <CR> will advance one line. Entering ESC will advance you to the end of that file. The space bar will then exit from that file. If you have selected to view more than one file, the next will automatically be displayed. After all selected files have been viewed, the window will close, returning you to DISK MAGIC's main screen. 5.4 File Functions ARC - Select all Files to be Archived in the source window (highlighted), click in the parameter entry field and enter the name of the new Archive (TEST). If the destination directory is RAM: then (TEST.ARC) is the file name. Then Select ARC. The archive name doesn't need anything entered in the parameter entry field. It will default to .ARC. The archive will be created in the destination directory. If the destination directory was RAM: then the archive will be created in ram:TEST.ARC. If the destination is df0:DIR1 then the ARC file name would be DF0:DIR1/TEST.ARC. ARCLST - This lists all files in the selected ARC files in the highlighted source window. ARCS - ARCS each highlighted file as an individual archive. This is great for doing multiple archives of picture files etc. The archive name will be the destination directory + the files's name + .ARC. ASSIGN - This gives the system assign list. BYTE - Adds up the number of bytes of the selected files in the highlighted source directory and displays the sum and the number of files. Remember that each file takes up 512 more bytes than indicated because of its directory entry. COPY - Copy selected files and directories to the directory specified in the unhighlighted destination string gadget. It must be an existing directory path and CAN go across devices. You should be able to enter paths relative to the current directory. NOTE! you can select both directories and files to be copied now. and all are done at the same time. DELETE - Delete selected files and directories in the Highlighted source directory. DINFO - Used to show the number of USABLE bytes from the DEVICE associated with the unhighlighted destination directory. DE-ARC - Select one or more Arced files,then select DE-ARC. The files will be un arced and placed on the destination device and directory. This also works in ram: If the file being DE_ARCED is already in the destination directory DISK MAGIC will over write the old file. DE-ZOO - Operates the same as DE-ARC. EXECUTE - Now executes an execute file selected in the highlighted source window and passes the parameters from the parameter entry field. GRENAM - This is a global rename function. Commands are entered in the parameters entry field with the following format. +)abcd adds the characters 'abcd' to the front of all highlighted files. +(.pic Adds the characters '.pic' to the back of all highlighted files. -)3 Removes 3 characters from the front of all highlighted files. -(3 Removes 3 characters from the back of all highlighted files. #?abcd>efgh This searches all files highlighted for the string 'abcd' and replaces the string with the string 'efgh' fileabcd.pic->fileefgh.pic. MOVE - Same basic principle as RENAME, but assumes that you want to just move the file to a new directory, not actually rename it. It will move multiple files from one directory to another. MOVDEL - This is like a rename between devices. What it does is move files from the highlighted source window to the unhighlighted destination window from one device to another and then deletes the source files. PAK - Operates the same as ARC. NOTE: to un pack a file select the file in the source window and click the RUN gadget. PAKLST - Operates the same as ARCLST. RENAME - Renames first selected file or directory to the name or path specified in the highlighted source directory. ex: click on the highlighted string gadget and enter the following: ram: ---> ram:newdirectoryname or ram:DIR1 ---> ram:DIR1/newdirectoryname then click the gadget. The file will be renamed and the current directory will be returned to: ram: or ram:DIR1 respectively. RUN - "RUNS" the selected files from inside DISK MAGIC. If DISK MAGIC was called from CLI, any output from the program is directed to the calling CLI. Parameters may be passed to the program by entering them in the E window. SHOW - Select the IFF files you wish to display, one or more, then click on the SHOW gadget. DISK MAGIC will attempt to display these files. This function will work with most, but not all forms of IFF files. If DISK MAGIC can not display the file, an error message will be displayed in the error msg. window and DISK MAGIC will go on to the next selection, if there is one. DISK MAGIC opens a new screen for the IFF file, displays the file, then waits for you to continue. When finished viewing the image, click in the upper-left corner of the image. There is an invisible close gadget located there. DISK MAGIC will close the screen and proceed to display the next file. The user may also define a paused timer between files instead of using the close gadget. See section 7.2. SINFO - Used to show the number of USABLE bytes from the DEVICE associated with the highlighted source directory. ZOO - Operates the same as the ARC function. ZOOLST - Operates the same as the ARCLST function. 6.0 USER DEFINED GADGETS AND MENUS 6.1 Directory Gadgets And Menus Directory gadgets and a directory menu can be defined by the user and the process to define these are described is section 7.0. 6.2 Program Menus Program menus are a set of 6 menus allowing for six catagories of functions with 18 functions in each menu can be defined by the user to execute their favorite programs. The process to define these Menus are described in section 7.0. 7.0 DISK MAGIC DEFINITION FILE This directory utility can have multiple commands executed by each menu item. See section 7.7 for details. USER DEFINED FILE COMMANDS AND DIRECTORY GADGETS. There are 14 USER definable on screen directory commands, 108 user definable menu commands, and 18 user definable menu directories that can be defined in the file DISKMAGIC.data. This file can be edited by any editor and contains 14 tables. The following sections describe these tables. 7.1 Color mode definition This value is either 4 or 8 indicating the number of colors that the CLI graphics interface should use. 7.2 Archive Pause Timer This value (0-99) indicates the pause time between ARC lists and DE-ARC actions. If the value is one then DISK MAGIC waits for user input of a carriage return an (ESC) key or a (SPACE) key. 7.3 Picture Pause Timer THis value (0-99) indicates the pause time between picture displays for the show command. If the value is one then DISK MAGIC then waits for the user to click the hidden close box. 7.4 Sound On/Off This flag turns the sound on or off. 1 = ON, 0 = OFF. 7.5 Start up Source Directory ***** CURRENT STARTUP DIRECTORIES #1 ***** df0:c This defines the source directory of the highlighted directory window at startup. At startup the program will read in this directory as the starting source directory. The size of this entry is 255 characters. 7.6 Startup Destination Directory ***** CURRENT STARTUP DIRECTORIES #2 ***** ram: This defines the destination directory of the unhighlighted window at startup. At startup the program will read in this directory as the starting destination directory. The size of this entry is 255 characters. 7.7 On Screen Directory Names ***** CURRENT DEFAULT DIRECTORY GADGET NAMES ***** DH0: DH1: DH2: DH3: RAM: VD0: ARC: JH0: JH1: SYST DF0: DF1: DF2: C: This next table in DISK MAGIC data defines the name of the gadgets (4 characters in length). As you can see it is possible to define a gadget called ARC: and then in the next table in section 6.5 define the directory that this gadget should get such as JH0:ARCHIVES/ARCHIVE1. 7.8 On Screen User Defined Directories ***** CURRENT DEFAULT DIRECTORIES ****** DH0: DH1: DH2: DH3: RAM: VD0: JH0:ARCHIVE JH0: JH1: df0:system DF0: DF1: DF2: df0:C This table as described above defines the directory the user would like to get when the gadget is selected. As another example the gadget defined as SYST when selected would get DF0:SYSTEM. This entry can be 255 characters long. 7.9 Program Menu Catagories ******* 7 CURRENT USER DEFINED MENU HEADERS ***** DIRECTORY WORDPROC GRAPHICS DESK TOP VIDEO ANIMATION UTILITIES The above table defines the 6 menu headers to categorize the user defined commands. The first one is default for the user defined menus described below. 7.10 User Defined Directory Menu Names ***** 18 USER DEFINED DIRECTORY MENU NAMES ***** C SOURCE ARCHIVE SYSTEM The above table defines the menu item names of the directories the user would like to define. Each entry may be 9 characters in length. 7.11 User Defined Menu Directories ***** 18 USER DEFINED DIRECTORIES ***** JH0:CSOURCE JH0:ARCHIVE JH0:WBB/SYSTEM The above table defines the directories that are activated when the user selects a given menu item in the directory menu. This field is 255 characters in length. 7.12 User Defined Menu Program Names ***** 18 USER DEFINED FUNCTION NAMES MENU 1 ***** EDIT ***** 18 USER DEFINED FUNCTIONS NAMES MENU 2 ***** DELUXE PAINT ***** 18 USER DEFINED FUNCTIONS NAMES MENU 3 ***** CITY DESK ***** 18 USER DEFINED FUNCTIONS NAMES MENU 4 ***** SILVER ***** 18 USER DEFINED FUNCTIONS NAMES MENU 5 ***** SHWANI ***** 18 USER DEFINED FUNCTIONS NAMES MENU 6 ***** NEWZAP NEWCLI DISKCOPY DF0:->DF2: FORMAT/INSTALL DF0: FORMAT df0: E=NAME ACCESS! ME! COMPILE! The next table found in DISKMAGIC.data and seen above defines an 18 character menu name for the user definable program menu item for each one of seven menus. 7.13 User Defined Menu Programs ***** CURRENT USER DEFINED PROGRAM CALLS MENU 1 ***** E ***** CURRENT USER DEFINED PROGRAM CALLS MENU 2 ***** CD JH0:PAINT\RUN DPAINT ***** CURRENT USER DEFINED PROGRAM CALLS MENU 3 ***** CD JH0:CITYDESK\RUN CityDesk_v1.1 ***** CURRENT USER DEFINED PROGRAM CALLS MENU 4 ***** SHOWANI -c ***** CURRENT USER DEFINED PROGRAM CALLS MENU 5 ***** SPLAYER ***** CURRENT USER DEFINED PROGRAM CALLS MENU 6 ***** CD JH0:WBBU\NEWZAP jh0:wbb/c/NEWCLI jh0:wbb/system/DISKCOPY <ram:CRT DF0: to DF2: jh0:wbb/system/FORMAT <ram:crt DRIVE df0: name "EMPTY"\INSTALL DF0: JH0:WBB/SYSTEM/FORMAT <RAM:CRT DRIVE CD JH0:TERMINALS\ACCESS! CD JH0:MANIX\EXECUTE SETRAM\ED DISKMAGIC.c The next table seen above is a 255 character entry that defines the program name and parameters etc that you would like for the user definable menu item to execute. For each entry you can have multiple commands. This is done by entering a '\' between each command. An example of this is seen above for dpaint. 7.14 User Defined Comments ** ****** USER COMMENT DEFINITIONS MENU 1 ***** now editing selected file ****** USER COMMENT DEFINITIONS MENU 2 ***** now running DELUXE PAINT II ****** USER COMMENT DEFINITIONS MENU 3 ***** now running citydesk ****** USER COMMENT DEFINITIONS MENU 4 ***** now showing SILVER ****** USER COMMENT DEFINITIONS MENU 5 ***** now showing selected animations ****** USER COMMENT DEFINITIONS MENU 6 ***** now zapping selected file opening a new CLI now COPYING DF0: TO DF2: ENTER NAME IN 'E' AS "NAME" AND CLICK AGAIN ENTER NAME IN 'E' AS 'NAME "test"' AND CLICK AGAIN now running ACCESS! The next table seen above is a user defined comment he or she would like displayed upon selecting the defined menu item. This again is 255 characters in length. 7.15 User Menu Format Definitions ****** USER COMMAND FORMAT DEFINITIONS MENU 1 ******* 301 ****** USER COMMAND FORMAT DEFINITIONS MENU 2 ******* 300 ****** USER COMMAND FORMAT DEFINITIONS MENU 3 ******* 300 ****** USER COMMAND FORMAT DEFINITIONS MENU 4 ******* 000 ****** USER COMMAND FORMAT DEFINITIONS MENU 5 ******* 000 ****** USER COMMAND FORMAT DEFINITIONS MENU 6 ******* 000 311 300 311 411 100 The above table is 3 characters in length. This defines a set of 3 flags and are used as follows: 1. The first flag is a program format flag. The default for this flag is 0. The following formats are defined where: PN = Is the Program name as defined in the table described above called USER DEFINED PROGRAM CALLS. This is the command line the user has defined that is executed when a given menu item is selected. EX = Is the 'P' window for entering parameters names etc. Anything the user enters in the P: window will be placed in the command string as defined by the format number defined below. SF = The current highlighted source files in the highlighted source directory. DD = The current destination directory. SD = The current highlighted source directory and no highlighted files as an example for diskcopy DF0: to DF1: SD = DF0:. DD = The current unhighlighted destination directory. So for this function diskcopy Df0: Df1: SD = DF0: DD = DF1: The following formats are defined 0. PN, EX, SF 1. PN, EX ,SD 2. PN, EX, SD, DD 3. PN, EX 4. PN, DD, EX 5. PN, EX, DD 6. PN, EX, DD, SD 7. PN, SD, EX EXAMPLE: Set PN to FORMAT DRIVE in the above table for the program name entries. Set the first flag in the table for the flags to 4. In the Parameters entry field enter NAME "ARC DISK" and in the unhighlighted directory have the directory DF2: The command would execute as follows: FORMAT DRIVE DF2: NAME "ARC DISK" In most cases 0 would be acceptable and the others are only used for programs that need directories specified instead of files. In the case of format 0 and the program is in MENU mode then the command line is passed as a command with no files. This allows the user to still have the ability to call programs such as scribble and specify the command being a format 0 which says the program gets passed a highlighted filename in graphics mode but in menu mode he can still access scribble but he will not be able to specify a file name. All program command lines are validated and should not give the user a system software error. If the command is not valid then a warning message is generated saying the command is invalid and also displays in the CLI window the menu number and item number of the error. All though the command line is validated it is possible to generate a program software error as described in the following example: Define the command line as a format 3. define the command line as follows: RUN DPAINT In this case DPAINT gives a system software error when passed a directory name as a parameter. The program giving the error is DPAINT so there is no way for DISK MAGIC to check for this kind of error. The next flag in the above table allows the user to define the function as needing double click protection. If this flag is set and the function is selected, DISK MAGIC will ask you to select the function again to activate the program. This is good for functions like diskcopy or fformat or FORMAT. The last flag allows the user to define this program to run in background mode. If this is set the function will execute and be run behind the DISK MAGIC screen on the workbench screen and will allow DISK MAGIC to be free for other actions. If a program is run in background you must click on the back gadget to get to the workbench screen to use the function. If the program is executed the DISK MAGIC screen automatically send the workbench screen to the front so as to allow the user to see the function. Upon exiting the function such as edit the workbench screen is placed in the back with the DISK MAGIC SCREEN in the front. 8.0 ALPHABETICAL LIST OF COMMANDS PRE DEFINED FILE COMMANDS ALL - Select ALL files in the current highlighted source directory, including the ones "scrolled off" the window. ALLDRS - Highlights all directories. ALLWND - Highlights all files in the highlighted source window (9 at a time). This is handy for archiving a directory that is two large for a 3 1/2" disk. ARC - Select all Files to be Archived in the source window (highlighted), click in the parameter entry field and enter the name of the new Archive (TEST). If the destination directory is RAM: then (TEST.ARC) is the file name. Then Select ARC. The archive name doesn't need anything entered in the parameter entry field. It will default to .ARC. The archive will be created in the destination directory. If the destination directory was RAM: then the archive will be created in ram:TEST.ARC. If the destination is df0:DIR1 then the ARC file name would be DF0:DIR1/TEST.ARC. ARCLST - This lists all files in the selected ARC files in the highlighted source window. ARCS - ARCS each highlighted file as an individual archive This is great for doing multiple archives of picture files etc. The archive name will be the destination directory + the files's name + .ARC. ASSIGN - This gives the system assign list. BYTE - Adds up the number of bytes of the selected files in the highlighted source directory and displays the sum and the number of files. Remember that each file takes up 512 more bytes than indicated because of its directory entry. CATLIST - This will list all files and directories and sub files and sub directories to the printer. This function starts from the Highlighted source directory found in the highlighted directory window. CLEAR - De-select all selected files in the highlighted source directory. CLRDIRS - Clears all selected directories in the highlighted source directory. CLRWIND - Clears all files in the highlighted source window. COPY - Copy selected files and directories to the directory specified in the unhighlighted destination string gadget. It must be an existing directory path and CAN go across devices. You should be able to enter paths relative to the current directory. NOTE! you can select both directories and files to be copied now. and all are done at the same time. DE-ARC - Select one or more Arced files,then select DE-ARC. The files will be un arced and placed on the destination device and directory. This also works in ram: If the file being DE_ARCED is already in the destination directory DISK MAGIC will over write the old file. DE-ZOO - Operates the same as DE-ARC. DELETE - Delete selected files and directories in the Highlighted source directory. DINFO - Used to show the number of USABLE bytes from the DEVICE associated with the unhighlighted destination directory. EXECUTE - Now executes an execute file selected in the highlighted source window and passes the parameters from the parameter entry field. GETDIR - GETS the current directory in the highlighted source window. You can also click on the directory windows and then type in a new directory. Upon hitting carriage return the new directory is read in. GRENAM - This is a global rename of multiple files. Commands are entered in the parameter entry filed with the following format. +)abcd Adds the characters 'abcd' to the front of all highlighted files. +(.pic Adds the characters '.pic' to the back of all highlighted files. -)3 Removes 3 characters from the front of all highlighted files. -(3 Removes 3 characters from the back of all highlighted files. #?abcd>efgh This searches all files highlighted for the string 'abcd' and replaces the string with the string 'efgh'! fileabcd.pic -> fileefgh.pic HTYPE - Types a file to the screen in HEX and ASCII 16 numbers at a time. MAKDIR - This will create the directory that you have typed in the highlighted source window gadget. You MAY use relative paths. ex: click on the highlighted string gadget and enter the following: ram: ---> ram:newdirectoryname or ram:DIR1 ---> ram:DIR1/newdirectoryname then click the gadget. The new directory will be made and the current directory will be returned to: ram: or ram:DIR1 respectively. The directory will be created in the highlighted source window. MOVE - Same basic principle as RENAME, but assumes that you want to just move the file to a new directory, not actually rename it. It will move multiple files from one directory to another. MOVDEL - This is like a rename between devices. What it does is move files from the highlighted source window to the unhighlighted destination window from one device to another and then deletes the source files. PAK - Operates the same as ARC. NOTE: to un pack a file select the file in the source window and click the RUN gadget. PAKLST - Operates the same as ARCLST. PARENT - Go to the parent directory in the highlighted source window. PRINT - THIS FUNCTION IS NOW RUN OF AS A BACKGROUND JOB!!! Same as TYPE, but the output goes to PRT: RENAME - Renames first selected file or directory to the name or path specified in the highlighted source directory. ex: click on the highlighted string gadget and enter the following: ram: ---> ram:newdirectoryname or ram:DIR1 ---> ram:DIR1/newdirectoryname then click the gadget. The file will be renamed and the current directory will be returned to: ram: or ram:DIR1 respectively. RUN - "RUNS" the selected files from inside DISK MAGIC. If DISK MAGIC was called from CLI, any output from the program is directed to the calling CLI. Parameters may be passed to the program by entering them in the E window. SHOW - Select the IFF files you wish to display, one or more, then click on the SHOW gadget. DISK MAGIC will attempt to display these files. This function will work with most, but not all forms of IFF files. If DISK MAGIC can not display the file, an error message will be displayed in the error msg. window and DISK MAGIC will go on to the next selection, if there is one. DISK MAGIC opens a new screen for the IFF file, displays the file, then waits for you to continue. When finished viewing the image, click in the upper-left corner of the image. There is an invisible close gadget located there. DISK MAGIC will close the screen and proceed to display the next file. Also see section 7.2 for the ability to select a timer pause to show pictures. Future updates are planned for v2.0. SINFO - Used to show the number of USABLE bytes from the DEVICE associated with the highlighted source directory. TYPE - Use this to view standard ASCII (readme, docs, etc) on stdout; usually your CRT. Select the files you want to view, then select the TYPE gadget. A new window, with the window name being the file that you are currently viewing, will open. Use the space bar to advance by one screen, a <CR> will advance one line. Entering ESC will advance you to the end of that file. The space bar will then exit from that file. If you have selected to view more than one file, the next will automatically be displayed. After all selected files have been viewed, the window will close, returning you to DISK MAGIC's main screen. WAND - Used to flip the Source highlight from one widow directory to the other. ZOO - Operates the same as the ARC function. ZOOLST - Operates the same as the ARCLST function. APPENDIX A. COPYRIGHT NOTICES PKAX by PAKWARE PKAX FAST! Archive Extract Utility Version 1.0 12-08-87 Copyright (c) 1987, PKWARE Inc. All rights reserved. PKAX -h for help. Extracts files from an archive to their original name, size, time, & date. Usage: PKAX [options] archive [file...] Options are: -r = replace existing files -v = verbose listing of archive(s) -c = extract file(s) to screen -p = extract file(s) to printer -t = test archive integrity -l = display software license -e,-x = extract file(s) archive Archive file name, wildcards *,? ok. Default extension is .ARC file Names of files to extract. Wildcards *,? ok. Default is ALL files. If you find PKAX fast, easy, and convenient to use, a registration of $25 would be appreciated. With each registration of $50 or more you will be registered to receive a diskette with the next version of PKAX & PKARC when available. PLEASE state the current version of the software which you have. Send contributions to: PKWARE, Inc. 7032 Ardara Avenue Glendale, WI 53209 ZOO COPYRIGHT NOTICE AmigaZoo is a user supported program. Zoo was written by Rahul Dhesi and modified to run on the Amiga by J. Brian Waters. With the consent of the author, I am requesting a $10-$20 contribution from satisfied users. This contribution is voluntary and you need not feel any guilt if you do not contribute. Any contributions received will go toward one of three things: firstly, and most importantly, they will be used to acquire any tools which may appear on the market to help make AmigaZoo better, like more optimizing C compilers or better debuggers; secondly, it will be used to help defray the costs of distributing Zoo; thirdly, if any money is still remaining it will be used to buy some shares of Commodore stock. In any case, you are encouraged to use and distribute this program in accordance with the conditions below. AmigaZoo is a derivative work of a program copyrighted by Rahul Dhesi and as such is subject to the following limitations on distribution: Distribution of the executable AmigaZoo is permitted subject to the following conditions. Any violation of these conditions may lead to damages in favor of the copyright owner. AmigaZoo 2.00 may be duplicated and distributed, or made available for downloading via telecommunications, for no fee above normal connect charges. It is prohibited to distribute AmigaZoo with any copyright notices removed. It is prohibited to distribute AmigaZoo and not allow the recipient to redistribute it. This file should be included in any distribution of AmigaZoo. Please note that AmigaZoo has different distribution conditions than the portable version of Zoo. These conditions allow any telecommunications service which does not claim a compilation right or charge a surcharge to distribute the AmigaZoo executable. These conditions allow AmigaZoo to be included on a disk sold at any price so long as you allow the recipient to redistribute AmigaZoo. Bug reports, suggestions, contributions etc. should be sent to: US Mail: J. Brian Waters c/o The Mackey Residence 1307 Alden Rd. Muncie, IN 47304 ARC COPYRIGHT NOTICE AmigArc - Archive utility, Version 0.16, created on 07/17/86 at 19:01 Compatible with ARC v5.0 (C) COPYRIGHT 1986 by Raymond S. Brand; ALL RIGHTS RESERVED (C) COPYRIGHT 1985,86 by System Enhancement Associates; ALL RIGHTS RESERVED Please refer all inquiries to: Raymond S. Brand c/o The Lido Hotel (a Fido BBS, node 16/630) (203) 248-7324 or AMuse (a Fido BBS, node 107/134) (212) 269-4879 You may copy and distribute this program freely, provided that: 1) No fee is charged for such copying and distribution, and 2) It is distributed ONLY in its original, unmodified state. If you like this program, and find it of use, then your contribution will be appreciated. You may not use this product in a commercial environment or a governmental organization without paying a license fee of $35 Site licenses and commercial distribution licenses are available. A program disk and printed documentation are available for $50. If you fail to abide by the terms of this license, then your conscience will haunt you for the rest of your life. Usage: ARC {amufdxerplvtc}[bswn][g<password>] <archive> [<filename> . . .] Where: a = add files to archive m = move files to archive u = update files in archive f = freshen files in archive d = delete files from archive x,e = extract files from archive p = copy files from archive to standard output l = list files in archive v = verbose listing of files in archive t = test archive integrity c = convert entry to new packing method b = retain backup copy of archive s = suppress compression (store only) w = suppress warning messages n = suppress notes and comments g = Encrypt/decrypt archive entry PAK COPYRIGHT NOTICE *** PAK Documentation *** File PAKer 1.0 - November 2, 1987 Copyright 1987 by Mark Riley All rights reserved. *** Description *** PAK is a utility for combining and compressing several smaller files into one large file. The PAKed file may then be uploaded to a BBS or another computer. Transmission time is reduced because PAKed files are compressed. Also, the receiving party does *not* require any special program to unPAK the files - PAKed files unPAK themselves! Unlike other utilities of its type, PAK imposes no restrictions on filenames. PAK's small size (under 5K) makes it handier than those written in high-level languages (PAK is written in 68000 Assembly Language.) PAK is simple to use, so have fun! This program is ShareWare; it isn't free. If you like it (or use it) please send a $10 contribution to the following address: Mark Riley - Pak P.O. Box 234 Simi Valley, CA 93062 Thank you! This contribution will help me to provide further low cost utilities for the Amiga (I've already got several queued up.) You may freely redistribute PAK in its original unaltered state. FIZ NAME fiz - analyze damaged zoo archive for data recovery AUTHOR Rahul Dhesi SYNOPSIS fiz archive[.zoo] DESCRIPTION Fiz is used to analyze damaged zoo archives and locate directory entries and file data in them. The current version of fiz is 2.0 and it is meant to be used in conjunction with zoo version 2.0.